home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / systems / emulate / 8_bit / xf2 / xf2faq.txt < prev   
Text File  |  1995-11-25  |  37KB  |  671 lines
  1.                                                      __ 
  2.              The Unofficial Atari 8bit              |||| 
  3.      Newbie / Stupid Question / Emulator Help      _||||_ 
  4.                          FAQ                      `\\  //' 
  5.                                                     `\/' 
  6.                   By Bill Kendrick 
  7.                     Revision 0.4                !! PLEASE !! 
  8.                   September 7, 1994          ASK MORE QUESTIONS 
  9.  
  10. Differences from Rev.0.3: Added info on DCM2DSK. 
  11. PLEASE also refer to: MyDOS 4.5 documents, SIO2PC documents, 
  12.   XF2 documents, and the Atari 8-bit F.A.Q. 
  13.  
  14. For general help (hardware, magazines, etc.) please check the Official 
  15. Atari 8-bit FAQ file: 
  16.   From: Michael Current <MCURRENT@carleton.edu> 
  17.   Where to get the latest copy of the Atari 8-Bit Computers  
  18.   Frequently Asked Questions List: 
  19.  
  20.   ftp://rtfm.mit.edu/pub/usenet-by-group/news.answers/atari-8-bit/faq 
  21.     (and many other FTP sites that archive Usenet FAQ Lists) 
  22.   http://www.cis.ohio-state.edu/hypertext/faq/usenet/atari-8-bit/faq/faq.html 
  23.   news:comp.sys.atari.8bit, news:comp.answers, news:news.answers 
  24.  
  25.   or, send a message to mailto::mail-server@rtfm.mit.edu that says: 
  26.  
  27.     send usenet/news.answers/atari-8-bit/faq 
  28.     quit 
  29.  
  30.   Finally, you can always ask Michael for a copy at 
  31.   mailto::mcurrent@carleton.edu 
  32.  
  33. Objective of this file: 
  34.      Much discussion has gone on in the comp.sys.atari.8bit Usenet 
  35. newsgroup about the newly released (mid 1994) Atari 8bit emulator for 
  36. IBM / MSDOS based computers, the PC X-Former 2.0 (XF2 for short).  Many 
  37. people in the 8-bit community have gotten, well, fed up with the XF2-based 
  38. questions which do not pertain to them, or to the really dumb questions 
  39. which are in fact understandable to new or rusty Atari 8-bit users, but 
  40. have just gotten on the nerves of some of the comp.sys.atari.8bit 
  41. readers/digest subscribers. 
  42.      This file was created to reduce the number of 'newbie' and XF2 
  43. questions. 
  44.      This FAQ will present answers to simple questions like "how do I turn 
  45. off BASIC" (a good answer to that of course is, READ THE FRIGGIN' MANUAL) 
  46. and "how do I get a disk directory?" (which is less obvious on 
  47. Atari 8-bits, err.. MOST 8-bits <grin>). 
  48.      It will also direct people who are unaware of the large amount of Atari 
  49. 8-bit support (NOT NECESSARILY EMULATOR SUPPORT) and perhaps become a 
  50. suplement for the many official and unofficial files floating around the 
  51. net (like the official FAQ, the Vendor/Developer List, the Who's Who list, 
  52. etc.). 
  53.  
  54. ---===  XF2 Questions:  ===--- 
  55.  
  56. Q.1) What does "READY" mean? 
  57. A.1) This is the Atari BASIC prompt.  See below for hints on Atari BASIC. 
  58.  
  59.  
  60. Q.2) Why doesn't this program load? 
  61. A.2.1) The program may not work under the Atari 800 Operating System, it may 
  62.        require the XL/XE Operating System (which XF2 does not emulate). 
  63. A.2.2) Be sure you turned BASIC off before trying to load it if it cannot 
  64.        run with BASIC on. 
  65. A.2.3) It may just refuse to run on the XF2 emulator. 
  66.  
  67.  
  68. Q.3) How do I turn off BASIC? 
  69. A.3) To toggle BASIC on and off, press [SHIFT]-[F10] ([F10] is [RESET], note: 
  70.      on a real Atari 8-bit, [SHIFT]-[RESET] does not have this effect). 
  71.  
  72.  
  73. Q.4) Why doesn't this game/program run correctly? 
  74. A.4.1) It may use player/missle collision detection which is not supported 
  75.        on the XF2. 
  76. A.4.2) (See Question 2). 
  77.  
  78.  
  79. Q.5) How do I exit XF2 and return to DOS? 
  80. A.5) Press [F5].  Note: this does NOT temporarily 'shell' or 'jump' to MSDOS. 
  81.  
  82.  
  83. Q.6) How do I get to Atari DOS? 
  84. A.6.1) In BASIC, type "DOS" at the "READY" prompt. 
  85. A.6.2) Reboot without BASIC on. 
  86. A.6.3) Be sure you have a DOS-bootable disk image as the first MSDOS 
  87.        parameter after the "XF2" command.  (DOS25.XFD and MYDOS45.ATR are 
  88.        both DOS boot-disk-images and are both in the XF2.ZIP file). 
  89.  
  90.  
  91. Q.7) How do I use MSDOS files with XF2? 
  92. A.7.1) Add the files to the command line and use them as their respective 
  93.        drives (be sure the first drive is a DOS-bootable disk image). 
  94.        Example:  XF2 MYDOS45.ATR filename.ext 
  95.        When booted the Atari will have two drives, D1: will be the MyDOS 
  96.        4.50 disk image and D2: will be a write-protected disk which contains 
  97.        only the file "filename.ext".  Note: there are bugs in XF2 which 
  98.        make accessing files from different directories a bit hard, just use 
  99.        the MOVE (or COPY and DEL) commands in MSDOS to get the file to the 
  100.        directory where you call XF2 from. 
  101. A.7.2) Use the MSDOS program S2PC (S2PC.ARC available in the Utilities 
  102.        directory at the UMICH archives) which allows you to access files 
  103.        within a MyDOS/compatible .ATR disk image without using an SIO2PC 
  104.        or the XF2.  S2PC let's you read, write, delete, change directory, 
  105.        and view the directory of a MyDOS/compatible .ATR disk image.  It 
  106.        can be used via command-line parameters from MSDOS, or as a menu. 
  107.  
  108.  
  109. Q.8) Just what ARE .ATR and .XFD files? 
  110. A.8.1) Refer to the XF2 and SIO2PC manuals for details on these files. 
  111. A.8.2) Simply put, they are Atari disks, stored as files which are as big 
  112.        as the disk they represent (an 88k disk image will use 88k on the 
  113.        IBM).  .ATR files are used by SIO2PC (see below) as well as the XF2 
  114.        (and the S2PC program mentioned above).  .XFD files are used by 
  115.        ST X-Former (the Atari 8-bit emulator for Atari ST's) and 
  116.        PC X-Former (XF2). 
  117.  
  118.  
  119. Q.9) What's SIO2PC? 
  120. A.9.1) Refer to the XF2 and SIO2PC manuals for details on this program. 
  121. A.9.2) This is a program which runs on IBM/compatibles which, with the use 
  122.        of a simple (and relatively inexpensive) cable, makes the IBM act 
  123.        as though it were an Atari disk drive.  (Up to four drives, actually). 
  124.        It uses disk image files (.ATR's) and can also let the Atari access 
  125.        single IBM files (much like XF2 does) as a single file all alone in 
  126.        its own disk.  It also currently allows Print-Thru (all access to the 
  127.        Atari "P:" (printer) device can be redirected to the IBM's printer, 
  128.        screen, or MSDOS file; different translations/conversions are 
  129.        user-defined when the Print-Thru mode is turned on).  Finally, with 
  130.        the use of two programs on the Atari 8-bit (the only two programs 
  131.        that currently have anything to do with SIO2PC that have been written 
  132.        (to my knowledge) for the Atari 8-bit), the IBM can be controlled 
  133.        remotely (commands are sent from the Atari, typing on the IBM is not 
  134.        necessary) and files can be sent directly to the IBM's drives. 
  135.  
  136.  
  137. Note: The following sections will simply discuss Atari BASIC, the Atari OS, 
  138.       and Atari DOS 2.5 and MyDOS 4.50 (because these topics seem the most 
  139.       relevant to the less-knowledged/experienced XF2 users). 
  140.  
  141. ---===  Getting around on the Atari: DOS and OS ===--- 
  142. I. AtariDOS and MyDOS QuickReference: 
  143.  
  144. MyDOS presents the user with the following commands: 
  145.  
  146. [*]     Disk directory of current directory (like "dir *.*" in MSDOS) 
  147. [1]-[9] Disk directory of a disk drive (like "dir a:\*.*" - "dir i:\*.*") 
  148. [A]     Disk directory (like "dir <mask>" and optional output destination) 
  149. [B]     Quit to cartridge 
  150. [C]     Copy file(s) ("<source>,<destination>" copies from one place or 
  151.         disk to another, just "<source>" copies from one place on one disk 
  152.         in a drive to the same place on another disk in the same drive 
  153.         (asks for swapping)) 
  154. [D]     Delete file(s) (add "/N" to delete without being prompted first) 
  155.         (add ">*.*" or ":*.*" after a subdirectory name to delete the 
  156.         files within it.  A subdirectory name alone will delete the 
  157.         subdirectory (if it is empty and unlocked)).  (Acts like both 
  158.         "del" and "rd" in MSDOS.) 
  159. [E]     Rename file(s) (renaming multiple files is allowed, but be careful). 
  160.         (like "ren <old> <new>" in MSDOS - with MyDOS, use "," between 
  161.         old and new masks.) 
  162. [F]     Locks file(s) from overwrite, deletion and appending (like 
  163.         "attrib +r <mask>" in MSDOS.) 
  164. [G]     Unlocks file(s) (returns them to their default state). 
  165. [H]     Writes DOS files to a disk (this creates a disk which boots with 
  166.         the current version of MyDOS you are using and also has the menu 
  167.         file "DUP.SYS" on it as well).  (This is like "sys"(?) in MSDOS.) 
  168. [I]     Formats a disk (add "/N" after the drive number to do a quick-format 
  169.         of an already-formatted disk (ie, just a very fast delete "*.*"). 
  170. [J]     Duplicate disk (copies an entire disk, including boot sector, 
  171.         when using XF2, it's much quicker to just copy one .XFD or .ATR to 
  172.         another). 
  173. [K] 
  174. [L]     Load binary file: loads a compiled program.  (like "<filename>" in 
  175.         MSDOS, except any ".EXE", ".COM", ".OBJ", etc. is still required.) 
  176. [M]     Run at address.  Mainly for advanced users.  Reboot is "E477", 
  177.         reset is "E474" (these are the hex values of the addresses where 
  178.         the routines to reboot and reset are.) 
  179. [N]     MEM.SAV: when this is on, whenever you go to DOS (from BASIC, 
  180.         for example) it will write what is in memory to a file "MEM.SAV" 
  181.         so that when DUP.SYS (the menu) loads it isn't lost forever. 
  182.         When you exit DUP.SYS with the "B: Run Cartridge" command, MEM.SAV 
  183.         is reloaded and the environment should be as it was when you left. 
  184.         It's probably quicker to simply "SAVE" your programs (if in a 
  185.         language) which aren't nearly as big as all of the memory that 
  186.         MEM.SAV saves. 
  187. [O]     Options: this presents the user with some options.  Mainly for 
  188.         advanced users or special setups.  See the MyDOS docs for details. 
  189. [P]     Set density.  Forces a drive to be recognized at a certain density 
  190.         if MyDOS can't figure it out. (??) 
  191. [Q]     Make a subdirectory. (like "md" or "mkdir" in MSDOS). 
  192. [R]     Set default directory. (like "cd" in MSDOS and "cwd" in SpartaDOS) 
  193.         This makes "D:" now the same as a subdirectory or other drive. 
  194.         ie, "D2:" will make all calls to "D:" act as though they are to 
  195.         "D2:" instead.  Some programs when prompting for filenames do not 
  196.         add "D:" to the beginning if one is not present, they add "D1:". 
  197.         If you don't trust a program to look to "D:" instead of "D1:" and 
  198.         you want it to look to some place OTHER than "D1:" (ie, where "D:" 
  199.         is pointing which could be a VERY long path list), just add "D:" 
  200.         to the beginning.  ALSO, some programs don't even ADD "D:"'s if they 
  201.         aren't in the filenames you give and may give errors (138, for 
  202.         example: device not present, ie, if you said "TESTFILE.DAT" it 
  203.         may think you want "T:" instead of "D:TESTFILE.DAT"). 
  204. [S]     Set ramdisk number.  This is also under [O]ptions. 
  205. [V]     Verify writes.  This is also under [O]ptions.  When Verify is on, 
  206.         writes will be slower but 100% reliable.  With it off, writes will 
  207.         be much faster but possibly not as reliable (on bad disks, for 
  208.         example).  Default is off. 
  209.  
  210. AtariDOS presents the user with the following commands which are identical 
  211. to MyDOS's commands: A,B,C(no swaping),D,E,F,G,H,I(some densities),J,K,L,M,N 
  212.  
  213. AtariDOS 2.5 presents the user with the following commands not present or 
  214. not the same as MyDOS's commands: 
  215. [O] Duplicate file.  This is used to copy a file from one disk to another 
  216.     using only one drive. (In MyDOS, giving just a source will make 
  217.     [C]opy act like DOS 2's Duplicate.) 
  218. [P] Format Single.  In DOS 2.5, this is used to format 88k (Single Density) 
  219.     disks.  To format an Enhanced Density (127k) disk, just use [I]. 
  220.     In DOS 2.0, [I] is the only format option and only handles 88k. 
  221.     (I may be wrong, but I have never had a Double Density drive under 
  222.     Atari DOS 2.0 or 2.5!) 
  223.  
  224. II. General DOS and OS questions: 
  225.  
  226. Q.1) How do I access the disk drives? 
  227. A.1) First, you need to have booted with a DOS.  All but one DOS is on 
  228.      disk (SpartaDOS X is on cartridge).  When the Atari boots up, it 
  229.      does some of its 'boot-up stuff' which includes looking for a 
  230.      disk drive connected and turned on which is set up as drive #1. 
  231.      It then begins to load from the disk's "boot sector".  If none 
  232.      exists or there's a nasty error on the disk, you get the 
  233.      "BOOT ERROR" notice until the error is fixed.  (On SpartaDOS disks, 
  234.      even non-bootable disks have a boot sector, but all the boot 
  235.      sector is is a small program which displays a 'not a boot disk' 
  236.      error). 
  237.      To end the digression, the answer to 'how do I access the disk 
  238.      drives' starts with 'you must boot the Atari with a DOS'.  Check 
  239.      the 8-bit FAQ and the UMICH and other FTP archives for lists of 
  240.      DOSes available for Ataris, but the most used are Atari DOS (for 
  241.      compatibility with almost ALL older software), MyDOS (for an 
  242.      Atari DOS compatible high-end DOS), and SpartaDOS (for a very 
  243.      high-end DOS which looks much like MS-DOS but unfortunately 
  244.      cannont run all software which runs fine with Atari DOS and 
  245.      MyDOS.)  Note: SpartaDOS does NOT run on Atari 400's and 800's 
  246.      (except the cartridge versions and I believe disk version 1.1). 
  247.      Now that you have a DOS loaded, the Atari understands the 
  248.      "D:" device (see below for Atari devices).  Since there is more 
  249.      than one disk drive, you have to be able to tell them apart. 
  250.      The Atari uses numbers when it has more than one of the same 
  251.      device, so "D1:" is drive 1, "D2:" is drive 2, "D3:" is drive 3, 
  252.      etc.! 
  253.      After the "D:" device name comes the filename.  Of the most used 
  254.      DOSes, only MyDOS supports lowercase letters in filenames, but 
  255.      since most programs force uppercase entry for filenames, nobody 
  256.      really seems to use lowercase in their filenames. 
  257.  
  258.  
  259. Q.2) How do I copy things from one place to another? 
  260. A.2) Atari DOS and MyDOS give you the "C" command in their menu 
  261.      interface.  When it asks for a source and destination, you can 
  262.      use wildcards (* and ? like in most other DOSes) to copy more 
  263.      than one file at a time.  You can also present no destination 
  264.      so that a file can be copied from one disk in drive 1 to another 
  265.      disk in drive 1, for example, and the DOS will ask you to insert 
  266.      each disk. 
  267.  
  268.  
  269. Q.3) What are subdirectories? 
  270. A.3) Subdirectories are places where files go which are just like the 
  271.      normal directory of a disk, except the they happen to be WITHIN 
  272.      that normal directory, or even another subdirectory.  For example, 
  273.      you can have your disk divided up into the "GAMES" files, the 
  274.      "GRAPHICS" files and the "SOUNDS" files.  A directory of the disk 
  275.      (the "root" or "base" or "trunk" directory) will simply list the 
  276.      three subdirectories, "GAMES", "GRAPHICS" and "SOUNDS".  Then, 
  277.      if you ask for a directory listing of the "GAMES" subdirectory, 
  278.      you will see the files (and perhaps other subdirectories) within 
  279.      the "GAMES" directory.  Think of it as a tree.  For people familiar 
  280.      with Macintoshes, "Folders" are simply subdirectories.  A window 
  281.      which appears when you open a "Disk" Icon is the "root", and all 
  282.      of the "Folders" within it have more windows in them which also 
  283.      have file and folder icons. 
  284.      Here's a comparison to using subdirectories on different DOSes 
  285.                     root  'GAMES'   'SPACE' within 'GAMES' 
  286.        AtariDOS      D:     n/a              n/a 
  287.        MyDOS         D:   D:GAMES:     D:GAMES:SPACE: 
  288.        SpartaDOS     D:   D:GAMES>     D:GAMES>SPACE> 
  289.        MSDOS (IBM)   \    \GAMES\       \GAMES\SPACE\ 
  290.      Note, only Atari DOS would be using drive 1 here, all other DOSes 
  291.      are not necessarily using drive 1, and MyDOS and SpartaDOS may 
  292.      already 'be within' a subdirectory. 
  293.      In MyDOS and SpartaDOS (and MSDOS), you can change the 'current' 
  294.      or 'default' directory to a different place (a different drive or 
  295.      a subdirectory).  "D:" can stand for "D1:" (like AtariDOS always 
  296.      does) or "D2:GAMES:SPACE:"!  PLEASE READ THE MYDOS DOCUMENTS FOR 
  297.      DETAILS ON THIS! 
  298.  
  299.  
  300. Q.4) What does "P:", "E:", "K:", etc. mean? 
  301. A.4) As stated before, the Atari has devices.  "D:" is added when a 
  302.      bootable disk in drive 1 is read.  Other exist as well: 
  303.        C:   cassette - readable and writeable, no filenames 
  304.        D:   disk drive - readable, writeable, random access, directory, 
  305.             files, multiple devices (up to 9 on MyDOS and newer SpartaDOS, 
  306.             8 on AtariDOS) 
  307.        E:   editior - readable, writeable.  This is how input from the 
  308.             keyboard and output to the screen is normally handled.  If 
  309.             you wish to type a small file up by hand and have it sent to 
  310.             the printer or a file, use "E:" as the source. 
  311.        K:   keyboard - readable.  This is just the keyboard.  Input from 
  312.             it is not 'echoed' back like with the "E:ditor". 
  313.        P:   printer - writeable.  Send data to this and it will appear 
  314.             on the printer.  You can print files (documents, etc.) by 
  315.             using "P:" as the destination.  The Atari XL/XE OSes support 
  316.             "P1:" and "P2:", although I believe this usage is rare. 
  317.        R:   RS232 - readable, writeable, concurrent mode.  This is not 
  318.             built in to the Operating System, but is loaded.  It supports 
  319.             modems.  The Atari 850 Interface has it's "R: handler" 
  320.             'built-in', which means the Atari also looks for an 850 (or 
  321.             other compatible interface) and receives the "R: handler" code 
  322.             from it.  Other interfaces and the Atari 'direct-connect' 
  323.             modems require a file to be loaded which contains the "R:" 
  324.             code.  "R1:" and "R2:" is also supported, but also its usage 
  325.             seems rare. 
  326.        Z:   RTime8 clock - readable, writeable.  This is also not built 
  327.             in to the OS, but loaded.  This is loaded from disk and lets 
  328.             the user access the "RTime8" real time, battery-backed up clock 
  329.             for the Atari 8-bit.  (This is a cartridge-based device). 
  330.             I am unaware of any "Z:" clone which let's you set the Atari 
  331.             internal (non-real time, non-battery-backed-up) clock if you 
  332.             do not have an RTime8, although I'd love to see one! <hint!!> 
  333.  
  334.  
  335. Q.5) How do I print something from DOS? 
  336. A.6) As stated above, just use the "C"opy command, then use the file 
  337.      you wish to print as the 'source', and "P:" as the 'destination'. 
  338.      Example:  "D1:DOCUMENT.TXT,P:" 
  339.  
  340.  
  341. ---===  Getting around on the Atari: BASIC ===--- 
  342.  
  343. Q.1) What does "READY" mean? 
  344. A.1) Again, this is simply the prompt that Atari BASIC (and most older 
  345.      BASIC's) presents the user when it is in "Immediate" mode. 
  346.      Entering a command will cause it to act immediately. 
  347.      Entering a line number and then a command will place that line into 
  348.      the current program. 
  349.      Entering a line number alone will remove that line from the current 
  350.      program. 
  351.      To start a program, use the "RUN" command. 
  352.      To erase a program, use the "NEW" command. 
  353.      To clear variables, strings and arrays, use the "CLR" command. 
  354.      To load a program, use the "LOAD" command followed by a filename 
  355.      (see below).  To load and run a program, use the "RUN" command followed 
  356.      by a filename. 
  357.      To save a program, use the "SAVE" command followed by a filename. 
  358.      To list a program, use the "LIST" command followed by an optional 
  359.      start and end set of lines seperated by commas. 
  360.  
  361.  
  362. Q.2) Where can I learn Atari BASIC? 
  363. A.2) A (set of) file(s) will be created explaining all of Atari (and Turbo) 
  364.      BASIC's commands and their usage.  (A larger file may be produced 
  365.      which will be based on examples provided in the Atari BASIC Reference 
  366.      Manual).  (As of today, 7/23/94, these particular files do not exist). 
  367.  
  368.  
  369. Q.3) How do I quit BASIC? 
  370. A.3.1) Type "DOS" to quit BASIC and return to DOS. 
  371. A.3.2) Type "BYE" to quit BASIC and exit to the OS's "bye" routines 
  372.        (Atari Memo Pad on 400/800's, Atari Rainbow on 1200XL's, and 
  373.        Self Test on other XL's and XE's).  (Note: On 1200XL's, use [HELP] 
  374.        to go to the Self Test when the Atari Rainbow appears). 
  375. A.3.3) For XF2 users, remember, [SHIFT]+[F10] reboots and toggles BASIC. 
  376.  
  377.  
  378. Q.4) Why don't strings work? 
  379. A.4) Strings must be "dimensioned" like arrays in Atari BASIC.  Strings 
  380.      are special character arrays.  See the BASIC usage/etc. files mentioned 
  381.      in the answer to question 2.  Simply put, to make a string that will 
  382.      accept up to "#" character, use  DIM <name>$(#)  .  Example: 
  383.      DIM A$(10)  - now A$ can contain between 0 and 10 characters. 
  384.  
  385.  
  386. Q.5) How do I make graphics? 
  387. A.5) Use the "GRAPHICS" command to switch between the following screen modes: 
  388.      (Note: All modes except 0, 9, 10 and 11 have four lines of 40 x 24 x 2 
  389.      sized text covering the bottom of the screen.  Add "16" to the mode 
  390.      number to remove this window (but do not make any PRINTs or PUTs to 
  391.      the standard output otherwise a GRAPHICS 0 screen will appear)) 
  392.      (Note: Add "32" to the mode number to keep the screen from clearing 
  393.      when it appears.  One problem, however, all screens overlay each other 
  394.      so unless you only use certain modes at certain times, parts of some 
  395.      screens will become (or start out) with 'garbage' on them.) 
  396.      0    40 x 24 x 2 text 
  397.      1    20 x 24 x 5 text 
  398.      2    20 x 12 x 5 text 
  399.      3    40 x 24 x 4 graphics 
  400.      4    80 x 48 x 2 graphics 
  401.      5    80 x 48 x 4 graphics 
  402.      6   160 x 96 x 2 graphics 
  403.      7   160 x 96 x 4 graphics 
  404.      8   320 x 192 x 4 graphics 
  405.      9    80 x 192 x 16 luminence-only graphics 
  406.     10    80 x 192 x 9 graphics 
  407.     11    80 x 192 x 16 hue-only graphics 
  408.     12    40 x 24 x 4-colored text 
  409.     13    40 x 12 x 4-colored text 
  410.     14   160 x 192 x 2 graphics 
  411.     15   160 x 192 x 4 graphics 
  412.      Commands available in Atari BASIC for manipulating simple graphics 
  413.      include: 
  414.        PLOT x,y      POSITION x,y    COLOR c (c=color or character value) 
  415.        DRAWTO x,y    LOCATE x,y,r  (where r is where result will be stored) 
  416.        SETCOLOR c,h,l  (c=palette location, h=hue, l=lum) 
  417.      Colors: 
  418.        COLOR command colors are not identical to SETCOLOR command colors: 
  419.          COLOR 0  will draw using the background color, set with 
  420.                   SETCOLOR 4,hue,lum 
  421.          COLOR 1  will draw using color "0", set with 
  422.                   SETCOLOR 0,hue,lum 
  423.          COLOR 2  will draw using color "1", set with 
  424.                   SETCOLOR 1,hue,lum 
  425.          COLOR 3  will draw using color "2", set with 
  426.                   SETCOLOR 2,hue,lum 
  427.         Except in GRAPHICS mode 10, where COLORs 0, 1, 2, and 3 must be 
  428.           POKEd into memory locations 704, 705, 706 and 707 (the 
  429.           player/missle graphics color locations).  Examples of this will 
  430.           be presented in the BASIC usage files.  (Sorry) 
  431.  
  432.  
  433. Q.6) How do I make sound on the Atari 
  434. A.6) Remember, XF2 doesn't support sound!  But, anyways, in Atari BASIC: 
  435.      SOUND c,p,d,v 
  436.      c=channel (0-3) 
  437.      p=pitch (0-255) 
  438.      d=distortion (0,2,4,6,8,10,12 or 14) 
  439.      v=volume (0-15) 
  440.      The buzzer character is CHR$(253) aka [CONTROL]+[2] (NOT [CONTROL]+[G]) 
  441.  
  442.  
  443. Q.7) How do I move the cursor and edit? 
  444. A.7) The Atari "E:" device (standard input/output which is the "editor") 
  445.      allows the following characters for editing: 
  446.  
  447.      Key:             AtASCII #:      Use: 
  448.      Atari              none    Turn inverse on/off (Atari 400/800 kybds) 
  449.      Inverse [Triangle] none    Turn inverse on/off (Atari XL/XE kybds) 
  450.      CAPS               none    Turns caps-mode to lowercase (400/800 OS) 
  451.      CAPS               none    Toggles caps-mode from upper to lower (XL/XE) 
  452.      Sh-CAPS            none    Turns caps-mode to uppercase (all OSes) 
  453.      Ct-CAPS            none    Turns caps-mode to [Control]-[Lock] (all) 
  454.      Up ([^-])           28     Move cursor up 
  455.      Down ([^=])         29     Move cursor down 
  456.      Left ([^+])         30     Move cursor left 
  457.      Right ([^*])        31     Move cursor right 
  458.      Space               32     Move cursor right (overwrites w/Space char) 
  459.      BackSpace           126    Move cursor left (deletes previous char) 
  460.      Delete ([ShBkspc])  156    Deletes a (logical) line (1-3 physical lines) 
  461.      Insert ([Sh>])      157    Inserts a physical line 
  462.      Ct-Delete ([^Bksp]) 254    Deletes char under cursor, pulls rest left 
  463.      Ct-Insert ([^>])    255    Inserts space under cursor, pushes rest right 
  464.      ClearScn ([^<])     125    Clears screen 
  465.      Bell ([^2])         253    Sounds buzzer 
  466.      TAB                 127    Moves cursor to next TABstop 
  467.      ClrTAB ([^TAB])     158    Clears any TABstop under cursor 
  468.      SetTAB ([ShTAB])    159    Sets a TABstop under cursor 
  469.      ESC                  27    Sets ESCape (next edit char after is shown, 
  470.                                 not done, non-edit chars shown (like normal)) 
  471.      RETURN              155    Sends End Of Line (moves cursor to lowerleft 
  472.                                 of next line, accepts input) 
  473.      Note: Inverse characters have values of the normal version of the 
  474.      characters plus 128.  (The only non-viewable inverse character is 
  475.      inverse-ESC, or what would be the [ESC],[RETURN] combination.  The 
  476.      character exists, but must be set into screen RAM by hand.  Oh well, 
  477.      at least you still have 255 easily viewable characters! <grin>) 
  478.  
  479.  
  480. Q.8) How do I make the editor characters appear 
  481. A.8.1) As shown above, you must have an ESC sent before them. 
  482.        When simply entering text, type [ESC] then the edit key and the 
  483.        character for that edit key should appear. 
  484.        When entering text in a PRINT statement, you must have it send an 
  485.        ESC beforehand, so first type [ESC],[ESC] to make an ESCape character 
  486.        appear, then type [ESC] then the edit key and the character for that 
  487.        edit key should appear.  When the PRINT statement is executed, the 
  488.        first ESCape (which you typed as two [ESC]'s) will make the editor 
  489.        SHOW the following character (even if it is an edit character), then 
  490.        the character which you entered (with [ESC] and then the edit key) 
  491.        will make that character appear.  This makes it difficult to align 
  492.        a set of PRINT statements which make a multi-line picture or menu 
  493.        which uses viewed edit keys.  It is probably best to have all of the 
  494.        lines in your program with the PRINT statements that can fit visible 
  495.        on the screen, then edit them (without putting any of the ESCape 
  496.        characters in, then when the picture looks like how you want it on 
  497.        the screen, move the cursor to on top of each edit-key character and 
  498.        press [Control]+[>] (Control-Insert).  A blank space should appear 
  499.        under the cursor and the rest of the line should move right.  Now, 
  500.        type [ESC],[ESC] and an ESCape edit-key character should appear 
  501.        where the blank space was.  When you are finished doing that for 
  502.        each line with those PRINTs in it, BE SURE TO ENTER THEM INTO THE 
  503.        PROGRAM BY PRESSING [RETURN] ON EACH OF THOSE LINES!  Whew! 
  504. A.8.2) Set the memory location "766" to "1" with the command "POKE 766,1" 
  505.        to turn on the no-edit mode (ALL characters except End Of Lines 
  506.        will appear, even ClearScreens!)  When you want to go back into 
  507.        normal mode, set the location back to "0" with "POKE 766,0". 
  508.  
  509.  
  510. Q.9) What's with the colors changing? 
  511. A.9) THIS, MY FRIEND, IS THE FIRST EVER SCREEN SAVER!  This is called 
  512.      "Attract mode" as was used on the Atari 2600 and Atari 400/800/XL/XE 
  513.      series (and probably on the 5200 and 7800 but I cannot confirm this). 
  514.      When a key hasn't been pressed for 7 or 9 (depending on OS, model, etc) 
  515.      minutes, the screen colors begin changing, thus protecting your TV 
  516.      or monitor from having a static image burned on it. 
  517.      To turn this mode off, press a key, or, if within a program, use the 
  518.      command "POKE 77,0" at least once every few minutes (IF the screen is 
  519.      active, otherwise turning it off would be kinda useless). 
  520.      To turn it on, wait 7 or 9 minutes without pressing a key or having 
  521.      location "77" set to "0", or set location "77" to "128" with 
  522.      "POKE 77,128", voila! instant attract mode! 
  523.  
  524.  
  525. Q.10) How do I access 'devices' on the Atari? 
  526. A.10) The following commands are available to Atari BASIC's (and also 
  527.       variations on these are available in most other Atari languages!): 
  528.       OPEN #a,b,c,d$    Opens channel 'a' for access to 'd$' in mode 'b' 
  529.                         with auxillary mode 'c'.  Channel 'a' must be 
  530.                         free or a 'Channel already open' (129) error 
  531.                         occurs.  Examples: 
  532.                           OPEN #1,4,0,"K:" - input from keyboard 
  533.                           OPEN #2,8,0,"P:" - output to printer 
  534.                           OPEN #3,12,0,"D:FILE" - random access to disk 
  535.                           OPEN #4,9,0,"D:DATA" - append-output to disk 
  536.                           OPEN #5,13,0,"R:" - concurrent to RS232 (modem) 
  537.                           OPEN #6,6,0,"D:*.TXT" - directory access to disk 
  538.                             (reads directory of "*.TXT" mask) 
  539.       CLOSE #a          Closes channel 'a' (freeing it for use) 
  540.       GET #a,b          Reads a byte from channel 'a' and stores it in 'b' 
  541.       PUT #a,b          Puts byte 'b' onto channel 'a' 
  542.       INPUT #a,b$       Reads a string (up to 255 bytes and a REQUIRED 
  543.                         'end of line' (character 155)) from channel 'a' 
  544.                         and stores it in 'b$' 
  545.       INPUT #a,b        Reads a string (up to 255 bytes and a REQUIRED 
  546.                         'end of line' (character 155)) from channel 'a' 
  547.                         and stores the numeric value of it in 'b' 
  548.       PRINT #a,<stuff>  Just like the normal BASIC PRINT statement, but 
  549.                         sends the information to channel 'a' (semicolons, 
  550.                         comas, and mixed types are of course allowed). 
  551.       STATUS #a,b       Reads the error 'status' of channel 'a' and stores 
  552.                         it in 'b' 
  553.       XIO a,#b,c,d,e$   General I/O call.  This a little complicated and 
  554.         may be expanded upon in a future revision.  Just be aware of the 
  555.         following: 
  556.           a - command 
  557.           b - channel to use (usually must be free) 
  558.           c - auxillary mode 1 
  559.           d - auxillary mode 2 
  560.           e$ - file or device to act upon 
  561.         Examples: 
  562.           XIO 32,#1,0,0,"D:FILE,OLDFILE" - renames file 
  563.           XIO 33,#1,0,0,"D:OLDFILE" - DELETES file 
  564.           XIO 34,#1,0,0,"D:GAMES" - creates a directory in My- & Sparta-DOS 
  565.           XIO 35,#1,0,0,"D:NEWFILE" - locks a file from over-write and 
  566.             deletion 
  567.           XIO 36,#1,0,0,"D:NEWFILE" - UNlocks a locked file 
  568.           XIO 40,#1,4,0,"D:PROG.OBJ" - loads and runs a binary file 
  569.             (like "L" in Atari and MyDOS) 
  570.           XIO 40,#1,5,0,"D:PROG.OBJ" - loads a binary file 
  571.             (like "L" in Atari and MyDOS with the "/N" option) 
  572.           XIO 41,#1,0,0,"D:GAMES" - changes default directory that 
  573.             drive/subdirectory (all calls to "D:" will now occur within 
  574.             that drive/directory) 
  575.           XIO 254,#1,0,0,"D2:" - FORMAT a disk (in Atari DOS 2.5, this is 
  576.             format 'enhanced', to format 'single' density, use XIO 253) 
  577.             (in MyDOS, this is format, but not 'enhanced', use 
  578.             XIO 253,#<channel>,1,0,"D<drive>:" for format a drive in enhanced 
  579.             mode). 
  580.         NOTE: 39 and 40 are the same.  Also note the useage of AUX1 in the 
  581.           "XIO 40" example. 
  582.  
  583.  
  584. ---===  Getting Atari files to an IBM:  ===--- 
  585.  
  586. Q.1) How can I read Atari disks on my IBM? 
  587. A.1.1) If you have double-density Atari disks, you can use the program 
  588.        "Util" on the IBM which can read double-density Atari disks.  Please 
  589.        see the Atari 8-bit FAQ for more details. 
  590. A.1.2) If you have an Atari 1050 disk drive, you can use the program MULE 
  591.        to copy files, one file at a time, 20k chunks at a time, from the 
  592.        Atari to the IBM.  You first must format a 180k disk on your IBM, 
  593.        the run MULE on your Atari to get a file onto the MULE disk, then 
  594.        run MULE on the IBM to get the file onto the IBM.  Tedious, isn't 
  595.        it?  MULE wasn't meant to be a fully-functional program, just a 
  596.        demo to show that this was even possible. 
  597. A.1.3) If you're fortunate to have a Black Box interface on your Atari, 
  598.        you can get an external IBM drive and the Black Box's add-on, the 
  599.        Floppy-Board and simply copy files from your Atari disks or hard 
  600.        drive(s) onto IBM disks via the floppy board, then load them up 
  601.        on your IBM. 
  602.  
  603. Q.2) Ok, I can't do any of that, now what? 
  604. A.2.1) You can use SIO2PC, which is a program for IBM's which turns your 
  605.        IBM into a set of Atari disk drives.  You need the SIO2PC cable 
  606.        (which you can purchase, assembled or unassembled, or buy parts 
  607.        and build it yourself) and the SIO2PC software (available at UMICH). 
  608.        Connect your IBM to your Atari, load SIO2PC, and then run the 
  609.        program FILE2PC on the Atari to transfer files to the IBM's hard 
  610.        drive.  Or instead create a disk image within SIO2PC and copy files 
  611.        from one disk (a real Atari floppy) to another (the SIO2PC image) 
  612.        with the Atari or MyDOS "C"opy command.  If you want to extract files 
  613.        out of the SIO2PC disk image file and store them on your IBM's hard 
  614.        drive or floppies as single files, either again use FILE2PC or use 
  615.        S2PC, an IBM program which can extract files from or add files to 
  616.        MyDOS-compatible SIO2PC disk images! 
  617. A.2.2) You can use two modems to download files from your Atari 8-bit. 
  618. A.2.3) If you don't necessarily want files that you already have on your 
  619.        Atari 8-bit, you can download files from the huge collection 
  620.        available at FTP sites and Atari 8-bit supporting bulletin boards 
  621.        and save them onto your IBM. 
  622. A.2.4) If you have only one modem, so you can't connect both your Atari 
  623.        8-bit and your IBM together via modems, you can do it via null- 
  624.        modem, OR you can upload files from your Atari to some bulletin 
  625.        board or account you have access to, and then connect the modem 
  626.        to your IBM and download the files. 
  627.  
  628. Q.3) Is there any easier way to get Disk Communicator (Atari disk image) 
  629.      files to and from SIO2PC disk images other than using Disk Comm. 
  630.      on my Atari!  I mean, both files are disk images!  They're both on 
  631.      my PC's hard drive!  <cry> 
  632. A.4) Yes!  There's a (currently it seems buggy) new IBM program out called 
  633.      DCM2DSK.  (Why "DSK" and not "ATR", I don't know.)  The current 
  634.      version is '0' and it's available at UMich's archives and probably 
  635.      elsewhere.  Filename: "DCM2DSK0.ZIP" in the SIO2PC directory. 
  636.  
  637. ---===  Where to FTP files mentioned in this FAQ:  ===--- 
  638.   The PC X-Former can be downloaded from the "ftp.clark.net" FTP site: 
  639.     Directory/file-path: systems/msdos/emulators/xf2.zip 
  640.   The following programs are availabel at the "archive.umich.edu" FTP site: 
  641.     SIO2PC: atari/8bit/sio2pc/*.* [all files are SIO2PC/utility files] 
  642.     MULE: atari/8bit/Utilities/???? 
  643.     Util: atari/8bit/Utilities/???? 
  644.  
  645. AGAIN, >>> PLEASE <<< CHECK OUT THESE OTHER FILES: 
  646.   ATARI 8-BIT FAQ 
  647.   PC X-FORMER DOCUMENTS 
  648.   MYDOS DOCUMENTS 
  649.   SIO2PC DOCUMENTS 
  650.  
  651. Thanx! 
  652.  
  653. Contacts: 
  654.  
  655. I (Bill Kendrick) can be contacted at: 
  656. mailto::kendrick@vax.sonoma.edu 
  657. on the "comp.sys.atari.8bit" and "comp.emulators.misc" newsgroups, or 
  658. New Breed Software, 59 Palm Lane, Novato, CA 94945. 
  659.  
  660. Darek Mihocka, the author of the PC X-Former can be contacted at: 
  661. mailto::darekm@microsoft.com 
  662. on the "comp.sys.atari.8bit" and other newsgroups, or 
  663. Branch Always Software, 14150 N.E. 20th Street, Ste 302, Belleuve, WA 98007. 
  664.  
  665. Michale Current, keeper of the Atari 8-bit FAQ files can be contacted at: 
  666. mailto::mcurrent@carleton.edu 
  667.  
  668. PLEASE add questions and report any mistakes or bugs to me ASAP. 
  669.  
  670. -bill 
  671.